Using the Generic HTML Connector

The Generic HTML Connector enables you to develop solutions that interact with the Chrome and Firefox browsers. From version 7.3, support was added for Microsoft Edge based on Chromium.

From version 7.6, support was added to work with these browsers in parallel (that is, with multiple browsers of different types open simultaneously).

From version 7.8, the Generic HTML connector supports:

• Manifest V 3 for Chrome and Edge.

• Capturing custom HTML tag elements.

• JavaScript from the web page for execution.

From version 7.9, the Generic HTML connector supports capturing shadow DOM elements.

To connect to Internet Explorer, use the Web Connector for Internet Explorer, as described in Using the Web Connector for IE.

The connector is installed automatically when you install the Real-Time Designer, and is enabled for capture. In order to capture from a web browser, you need to install and enable the NICE Browser Connector extension, as described in Using the Generic HTML Connector.

Enabling the Real-Time Designer and Client to Work with Generic HTML Screen Elements

The Generic HTML Connector is installed automatically when you install the Real-Time Designer, and is enabled for capture.

In order to capture from Chrome, Firefox, or Edge Chromium browsers, you need to install and enable the NICE Browser Connector extension. If you try and capture a screen element in a browser and the extension is disabled, a message appears, similar to the following:

Once you have enabled the extension, restart the browser before starting the Real-Time Designer and capturing browser screen elements.

To enable the Real-Time Designer and Client to work with the Generic HTML Connector:

1. Complete the Real-Time Designer installation process. For more information, see the Real-Time Client and Designer Server Installation Guide.

2. Start the Real-Time Designer and, in the Physical Objects tab, expand the Connectors Enabled for Capture drop-down list.

   

   Generic HTML is selected by default, indicating that it is enabled for capture. If necessary, clear the Generic HTML checkbox to disable the connector.

3. Install and enable the NICE Browser Connector for the browser(s) from which you want to capture objects with the Generic HTML Connector.

To install and enable the NICE Browser Extension for Chrome:

1. Open Chrome.

2. If the NICE Browser Connector added confirmation message appears, click Enable extension.

3. Open the Extensions page by typing chrome://extensions/ in the Chrome address bar.

   The NICE Browser Connector extension is installed automatically the first time you open Chrome after installing the Real-Time Designer or Real-Time-Client. In some cases however, your security settings may prevent the NICE Browser Connector from being installed. If you do not see the NICE Browser Connector extension on the Extensions page, click here to install from the Chrome Web Store.

4. Verify that the NICE Browser Connector extension is enabled. If it is not enabled, click the toggle switch to enable it.

   

To install and enable the NICE Browser Extension for Firefox:

1. Open Firefox.

2. In the top-right corner, click Open menu . If the NICE Browser Connector added to Firefox message appears, click it.

3. When you are prompted for confirmation, click Enable.

   The NICE Browser Connector extension is enabled and ready to use.

   

   To open the Manage Your Extensions page and manually enable the connector, type about:addons in the Firefox address bar.

To install and enable the NICE Browser Extension for Edge Chromium:

1. Open Edge Chromium.

2. If the NICE Browser Connector added confirmation message appears, click it.

3. On the Installed extensions page, browse to the NICE Browser Connector, and verify that it is enabled. If it is not enabled, click the toggle switch to enable it.

   The NICE Browser Connector extension is enabled and ready to use.

   The NICE Browser Connector extension is installed automatically the first time you open Edge Chromium after installing the Real-Time Designer. In some cases however, your security settings may prevent the NICE Browser Connector from being installed. If you do not see the NICE Browser Connector extension on the Installed extensions page, click here to install from Edge Add-ons.

   

   If the Installed extension page does not open automatically, you can open it by clicking the ellipsis in the top-right corner of Edge Chromium, and selecting Extensions from the menu.

4. The Edge extension ID in the URL must match the extension ID in nativehost.json as shown below.

   Edge extension ID in the URL:

   

   Edge extension ID in nativehost.json:

   

   If the Edge extension is not installed with the ID 'fjnfhlipapegbaekifmncoeoofmcbeff', remove the extension from Edge and install it from: https://microsoftedge.microsoft.com/addons/detail/nice-browser-connector/fjnfhlipapegbaekifmncoeoofmcbeff

Updating your NICE Browser Connection Extension in Firefox

Occasionally, you might be instructed to update your NICE Browser Connector extension in Firefox. In addition, if you are using Firefox 74 or higher, the NICE Browser Connector extension will not install automatically. To use this extension, either install the extension manually, as described in this procedure, or install an earlier version of Firefox.

To update your NICE Browser Connection Extension in Firefox:

1. Open Firefox, and type about:addons in the address bar to open the Manage Your Extensions page.

2. Click the Gear button .

3. From the menu, select Install Add-on From File.

   

4. Browse to the C:\Program Files (x86)\NICE Systems\Real-Time Client folder and select the nice_rti_firefox_connector-fx.xpi file.

   

5. Click Add.

   

6. To verify that the extension was updated, locate the NICE Browser Connector and click the ellipsis in the top-right corner.

7. Click Manage.

   

8. Verify the Last Updated date.